home *** CD-ROM | disk | FTP | other *** search
/ SGI Developer Toolbox 6.1 / SGI Developer Toolbox 6.1 - Disc 1.iso / toolbox / documents / OpenGL / extensions / man / glaretexturesresidentext.z / glaretexturesresidentext
Encoding:
Text File  |  1996-11-11  |  7.3 KB  |  133 lines
  1.  
  2.  
  3.  
  4. ggggllllAAAArrrreeeeTTTTeeeexxxxttttuuuurrrreeeessssRRRReeeessssiiiiddddeeeennnnttttEEEEXXXXTTTT((((3333GGGG))))   OOOOppppeeeennnnGGGGLLLL RRRReeeeffffeeeerrrreeeennnncccceeee   ggggllllAAAArrrreeeeTTTTeeeexxxxttttuuuurrrreeeessssRRRReeeessssiiiiddddeeeennnnttttEEEEXXXXTTTT((((3333GGGG))))
  5.  
  6.  
  7.  
  8. NNNNAAAAMMMMEEEE
  9.      ggggllllAAAArrrreeeeTTTTeeeexxxxttttuuuurrrreeeessssRRRReeeessssiiiiddddeeeennnnttttEEEEXXXXTTTT - determine if textures are loaded in texture
  10.      memory
  11.  
  12.  
  13. CCCC SSSSPPPPEEEECCCCIIIIFFFFIIIICCCCAAAATTTTIIIIOOOONNNN
  14.      GLboolean ggggllllAAAArrrreeeeTTTTeeeexxxxttttuuuurrrreeeessssRRRReeeessssiiiiddddeeeennnnttttEEEEXXXXTTTT( GLsizei _n,
  15.                                          const GLuint *_t_e_x_t_u_r_e_s,
  16.                                          GLboolean *_r_e_s_i_d_e_n_c_e_s )
  17.  
  18.  
  19. PPPPAAAARRRRAAAAMMMMEEEETTTTEEEERRRRSSSS
  20.      _n           The number of textures to be queried.
  21.  
  22.      _t_e_x_t_u_r_e_s    An array containing the names of the textures to be queried.
  23.  
  24.      _r_e_s_i_d_e_n_c_e_s  An array in which the texture residence status is returned.
  25.                  The residence status of a texture named by an element of
  26.                  _t_e_x_t_u_r_e_s is returned in the corresponding element of
  27.                  _r_e_s_i_d_e_n_c_e_s.
  28.  
  29. DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
  30.      On machines with a limited amount of texture memory, OpenGL establishes a
  31.      ``working set'' of textures that are resident in texture memory.  These
  32.      textures may be bound to a texture target much more efficiently than
  33.      textures that are not resident.
  34.  
  35.      ggggllllAAAArrrreeeeTTTTeeeexxxxttttuuuurrrreeeessssRRRReeeessssiiiiddddeeeennnnttttEEEEXXXXTTTT queries the texture residence status of the _n
  36.      textures named by the elements of _t_e_x_t_u_r_e_s.  If all the named textures
  37.      are resident, ggggllllAAAArrrreeeeTTTTeeeexxxxttttuuuurrrreeeessssRRRReeeessssiiiiddddeeeennnnttttEEEEXXXXTTTT returns GGGGLLLL____TTTTRRRRUUUUEEEE and the contents
  38.      of _r_e_s_i_d_e_n_c_e_s are undisturbed.  If not all the named textures are
  39.      resident, ggggllllAAAArrrreeeeTTTTeeeexxxxttttuuuurrrreeeessssRRRReeeessssiiiiddddeeeennnnttttEEEEXXXXTTTT returns GGGGLLLL____FFFFAAAALLLLSSSSEEEE and detailed status
  40.      is returned in the _n elements of _r_e_s_i_d_e_n_c_e_s.  If an element of _r_e_s_i_d_e_n_c_e_s
  41.      is GGGGLLLL____TTTTRRRRUUUUEEEE, then the texture named by the corresponding element of
  42.      _t_e_x_t_u_r_e_s is resident.
  43.  
  44.      The residence status of a single bound texture may also be queried by
  45.      calling ggggllllGGGGeeeettttTTTTeeeexxxxPPPPaaaarrrraaaammmmeeeetttteeeerrrr with the target argument set to the target to
  46.      which the texture is bound, and the parameter name argument set to
  47.      GGGGLLLL____TTTTEEEEXXXXTTTTUUUURRRREEEE____RRRREEEESSSSIIIIDDDDEEEENNNNTTTT____EEEEXXXXTTTT.  This is the only way that the residence status
  48.      of a default texture can be queried.
  49.  
  50.      ggggllllAAAArrrreeeeTTTTeeeexxxxttttuuuurrrreeeessssRRRReeeessssiiiiddddeeeennnnttttEEEEXXXXTTTT is not included in display lists.
  51.  
  52. NNNNOOOOTTTTEEEESSSS
  53.      ggggllllAAAArrrreeeeTTTTeeeexxxxttttuuuurrrreeeessssRRRReeeessssiiiiddddeeeennnnttttEEEEXXXXTTTT is part of the EEEEXXXXTTTT____tttteeeexxxxttttuuuurrrreeee____oooobbbbjjjjeeeecccctttt extension.
  54.      See ggggllllIIIInnnnttttrrrroooo for more information about using extensions.
  55.  
  56. EEEERRRRRRRROOOORRRRSSSS
  57.      GGGGLLLL____IIIINNNNVVVVAAAALLLLIIIIDDDD____VVVVAAAALLLLUUUUEEEE is generated if _n is negative.
  58.  
  59.  
  60.  
  61.  
  62.  
  63.                                                                         PPPPaaaaggggeeee 1111
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70. ggggllllAAAArrrreeeeTTTTeeeexxxxttttuuuurrrreeeessssRRRReeeessssiiiiddddeeeennnnttttEEEEXXXXTTTT((((3333GGGG))))   OOOOppppeeeennnnGGGGLLLL RRRReeeeffffeeeerrrreeeennnncccceeee   ggggllllAAAArrrreeeeTTTTeeeexxxxttttuuuurrrreeeessssRRRReeeessssiiiiddddeeeennnnttttEEEEXXXXTTTT((((3333GGGG))))
  71.  
  72.  
  73.  
  74.      GGGGLLLL____IIIINNNNVVVVAAAALLLLIIIIDDDD____VVVVAAAALLLLUUUUEEEE is generated if any element in _t_e_x_t_u_r_e_s is zero or does
  75.      not name a texture.
  76.  
  77.      GGGGLLLL____IIIINNNNVVVVAAAALLLLIIIIDDDD____OOOOPPPPEEEERRRRAAAATTTTIIIIOOOONNNN is generated if ggggllllAAAArrrreeeeTTTTeeeexxxxttttuuuurrrreeeessssRRRReeeessssiiiiddddeeeennnnttttEEEEXXXXTTTT is executed
  78.      between the execution of ggggllllBBBBeeeeggggiiiinnnn and the corresponding execution of
  79.      ggggllllEEEEnnnndddd.
  80.  
  81. AAAASSSSSSSSOOOOCCCCIIIIAAAATTTTEEEEDDDD GGGGEEEETTTTSSSS
  82.      ggggllllGGGGeeeettttTTTTeeeexxxxPPPPaaaarrrraaaammmmeeeetttteeeerrrr with parameter name GGGGLLLL____TTTTEEEEXXXXTTTTUUUURRRREEEE____RRRREEEESSSSIIIIDDDDEEEENNNNTTTT____EEEEXXXXTTTT retrieves
  83.      the residence status of a currently-bound texture.
  84.  
  85.  
  86. SSSSEEEEEEEE AAAALLLLSSSSOOOO
  87.      ggggllllBBBBiiiinnnnddddTTTTeeeexxxxttttuuuurrrreeeeEEEEXXXXTTTT, ggggllllPPPPrrrriiiioooorrrriiiittttiiiizzzzeeeeTTTTeeeexxxxttttuuuurrrreeeessssEEEEXXXXTTTT, ggggllllTTTTeeeexxxxIIIImmmmaaaaggggeeee1111DDDD, ggggllllTTTTeeeexxxxIIIImmmmaaaaggggeeee2222DDDD,
  88.      ggggllllTTTTeeeexxxxIIIImmmmaaaaggggeeee3333DDDDEEEEXXXXTTTT, ggggllllTTTTeeeexxxxPPPPaaaarrrraaaammmmeeeetttteeeerrrr.
  89.  
  90.  
  91.  
  92.  
  93.  
  94.  
  95.  
  96.  
  97.  
  98.  
  99.  
  100.  
  101.  
  102.  
  103.  
  104.  
  105.  
  106.  
  107.  
  108.  
  109.  
  110.  
  111.  
  112.  
  113.  
  114.  
  115.  
  116.  
  117.  
  118.  
  119.  
  120.  
  121.  
  122.  
  123.  
  124.  
  125.  
  126.  
  127.  
  128.  
  129.                                                                         PPPPaaaaggggeeee 2222
  130.  
  131.  
  132.  
  133.